created by Aha00aAha00a at 2026-11-04
last modified by Aha00aAha00a at 2026-11-20
revision: 13

ToDo InterpreterTable

InterpreterTable 을 어디까지, 어떤 순서로 키울지. 2026-11-02 소유자의 물음에서 시작했다 — «표에는 보통 수치가 많은데, 엑셀처럼 칸에 bar 를 넣는다든지, 발전시킬 방향이 없을까». 그때 만든 것(숫자 열, bar=, heat=, compact)의 규칙과 정한 것·하지 않은 것은 InterpreterTable 에 있다.

아래는 다섯 관점(엑셀·Notion 사용자, 스프레드시트를 붙여 넣는 글쓴이, 유지보수자, 차트, 견고성)이 따로 낸 제안을 회의론자 둘이 반박해 본 결과다 — 하나는 «이 코드베이스에서 되고 테마·인쇄·접근성·정렬·캐시에서 버티는가», 하나는 «글쓴이에게 맞는 문법이고 Table 에 속하며 쓸 일이 있는가». 둘 다 반박하지 못한 것은 다음 증분에, 하나가 반박한 것은 그 반박과 함께 요청이 있을 때에 있다. 갈린 것은 거의 다 «쓸 일이 있는가» 였다. 2026-11-16 에 소유자 관리 위키 다섯의 #!Table 156개를 실제로 열어 보니 인자는 거의 다 tsv 1·tsv 1 1 이었고(새 옵션을 쓴 표는 아직 없다), 합계 행으로 끝나는 표는 없었다.

만들 때는 제안 속 HTML 이 아니라 지금 코드(numeric · dataBar · negative · axis · sorter-digit · --bar-start)를 기준으로 한다.

1. 다음 증분

둘 다 반박하지 못한 것. 순서는 «지금 코드에 작게 얹히는 것» 과 «뒤의 것이 기대는 것» 부터다.

  • 없다. [[Sparkline(…)]] 는 2026-11-20 에 매크로로 만들었다 — MacroSparkline.

2. 요청이 있을 때

회의론자 하나가 반박한 것. 거의 모두 «되기는 하는데 아무도 안 물었다» 였고, 만들게 되면 어떤 모양이어야 하는지는 정해 뒀다.

  • 열 범위를 읽는 스파크라인 spark=2-7. 같은 행의 월별 열을 다시 타자하지 않고 선으로. 범위 문법은 bar= 의 것(2026-11-04)을 그대로, 그리기는 MacroSparkline.svg 를 그대로 쓴다. MacroSparkline 을 매크로로 만들면서 미뤘다 — 월별 열을 가진 표가 아직 없었다. 그런 표가 생기면.
  • foot=N — 마지막 N 행을 <tfoot> 으로. 시트에서 붙여 넣은 표는 제 합계 행을 갖고 오기도 한다. 지금 그 행은 본문이라 정렬하면 가운데로 섞이고, 필터에 걸리고, 막대의 척도가 합계를 기준으로 잡혀 나머지 막대가 전부 절반 이하가 된다 — 엑셀 사용자가 데이터 바 범위에서 합계를 빼는 바로 그 이유다. foot=1 은 마지막 행을 <tfoot> 으로 보낸다: 정렬·필터 밖에 남고(tablesorter 는 tbody 만 다시 붙인다), 숫자 열 판정과 척도에서 빠지며, 아무것도 더하지 않는다(그것은 sum=). 숫자 열의 footer 칸은 숫자면 numeric, 아니면 맨 <td>(data-text 없음). foot 은 rows.size - thRow 로 자른다. tablesorter 가 정렬한 열의 tfoot 칸에 aria-sort 를 쓰므로 AhaWiki.PageView.js 에서 떼어 낸다. 짝수 행·hover 배경이 tfoot 에도 먹으니 배경을 따로, 인쇄에서는 tfoot 이 쪽마다 반복되므로 display: table-row-group 으로 한 번만 — 둘 다 InterpreterTable 의 인쇄 절에. 2026-11-16 에 찾아봤고 없었다 — 소유자 관리 위키 다섯(aha00a.com·ahawiki.net·whohow.net·cellivery·docs.oddconcepts.net)의 #!Table 156개 중 합계·소계·평균·Total 같은 행으로 끝나는 표는 0개였다. 합계 행이 든 표를 붙여 넣는 페이지가 생기면.
  • 합계·평균 sum=2 · avg=2. foot= 뒤에 — 그래서 foot= 과 함께 여기로 내렸다. 명시한 열만 — sum=all 은 안 한다(숫자 열 판정은 정렬·정돈용이라 1월·2024년·12.5kg 열도 숫자이고, 그것을 굵게 더해 보여 주면 틀린 사실이 된다). 계산한 행은 글쓴이의 footer 행 뒤에 두고 footer 행은 더하지 않는다 — 붙여 넣은 합계가 두 번 더해지는 일을 이렇게 막는다. 합계는 BigDecimal 로 — 그러려면 InterpreterTable.parseNumber 가 Double 하나가 아니라 부호·통화·자릿수·소수 자리·단위를 든 구조를 돌려주도록 바꾸고(막대는 그 구조의 Double 을 쓴다), 표기는 «열의 모든 칸이 같은 접두·접미를 공유할 때만 그것을 붙이고, 아니면 빈 칸». 라벨은 합계·평균 또는 없음. 필터로 걸러도 합계는 전체라고 적는다.
  • 링 ring=(Notion 의 진행 원). 0..100 열이라면 bar= 가 이미 같은 비율을 막대로 보여 준다. 만든다면 ring=all|2,3|머리글 로 막대와 같은 축을 쓰고, 트랙 색 토큰을 --bar-color 옆에 두며, 원을 숫자 뒤에 놓아 열의 오른쪽 정렬을 지킨다. 진행률 열을 가진 페이지가 생기면.
  • 신호등 색 척도. heat= 와 범위 문법 뒤에, 콜론 네 번째 자리가 아니라 제 키로(gyr=3 — 엑셀의 갤러리 이름 순서대로 «위 값의 색» 부터). 적록은 색약에 가장 흔한 쌍이라 밝기도 달리하고, 숫자가 데이터이고 색은 힌트라고 문서에 적는다. 좋음·나쁨 척도를 쓸 페이지가 생기면.
  • 증감 화살표 delta=. 부호만(임계값 문법 없음), 칸 왼쪽 끝에 고정한 CSS 삼각형, 색은 --bar-color-negative 옆에. 그런데 부호는 이미 글자로 있고, 소유자의 스크린샷에 있던 그 열(8%, −3%, −8%)은 bar= 가 축 왼쪽의 붉은 막대로 이미 보여 준다. 막대 없이 화살표만 원하는 표가 생기면.
  • 숫자 서식 fmt=. 엑셀 서식 코드를 DecimalFormat 으로 — 는 안 된다. 엑셀 대화상자가 내놓는 코드들([Red], _), "원")을 DecimalFormat 은 글자 그대로 찍는다. 시트에서 붙여 넣은 글은 이미 서식이 든 글자이고, 그것이 이 표의 입력이다. 한다면 천 단위 구분과 소수 자리만, 허용 목록 정규식으로. 손으로 친 긴 숫자 열이 생기면.
  • 음수 글자색. 기본값으로 붉게 — 는 안 한다. 끄는 길이 없고(온도·좌표·차이 열도 전부 붉어진다), 막대 위의 붉은 글자는 대비가 4.4:1 로 모자라며, 막대의 붉은색은 «축 왼쪽» 이라는 자리가 부호를 주지만 글자색은 자리 없이 판단만 준다. «한국 금융 관행은 빨강이 오름» 은 근거로 쓰지 않는다 — 그 말은 막대의 붉은색에도 똑같이 걸린다(바꾼다면 --bar-color-negative 토큰 하나다). 한다면 음수 칸의 negative class 는 공짜로 주고(막대 칸은 이미 있다; tdOpen 을 다음에 건드릴 때 한 줄), 색은 글쓴이가 표 class 로 켜는 것으로.
  • 머리글 고정 sticky. 2026-11-18 — #!Table 다음에 InterpreterQuery·MacroPageList 의 표도 같은 CSS 로(머리글 행만). 정한 것은 InterpreterTable «머리글 고정». tablesorter 의 stickyHeaders 위젯은 쓰지 않았다 — 같은 곳에 이유가 있다.
  • 정렬 덮어쓰기 align=. 자동 판정을 열마다 뒤집는 것(연도 열을 왼쪽으로, 상태 열을 가운데로). 제안은 #!var align .r.c 였는데 #!var 는 문서 맨 위의 치환 변수라 뜻이 셋째가 되고, Table Editor 가 그 줄을 데이터 행으로 쓴다. 한다면 bar= 와 같은 채널의 align=3:l,상태:c 꼴. 단위가 붙은 열은 이미 숫자라 제안의 예시는 필요 없어졌다. 뒤집고 싶은 열이 생기면.
  • 행 번호 rownum. 서버가 칸을 만들면 번호가 행을 따라다니고 필터에 구멍이 난다 — 엑셀의 회색 행 머리글은 자리 번호다. CSS 카운터(tr::before { display: table-cell })면 서버 변경 없이 자리 번호가 되고 Table Editor 의 격자와도 안 어긋난다. 한다면 그쪽으로, 그리고 bar=N 의 번호는 글쓴이의 열만 센다고 적는다. 번호가 필요한 표가 생기면.
  • 에디터의 토큰 목록·칩. 서버가 토큰 목록을 내려 주고 Table Editor 에 토글 칩을 두는 안. 토큰 목록은 이미 edit.tableOptions.js 에 있고 InterpreterTable.scala 와 어긋나면 node 테스트가 잡는다(Dev Editor «자동완성») — 서버가 목록을 내려 줄 필요는 없다. 남은 것은 칩이다. 토큰이 더 생기면.
  • #!Chart — Table 의 TSV 를 echarts 로. 새 인터프리터(effort L). 저장소의 표 61개 중 차트가 필요한 것은 없었고, 묻지 않은 물음이다. 만든다면 정해 둔 것: 차트 종류는 bar 낱말이 아니라(Table 의 bar= 와 다른 뜻이 된다) 첫 낱말이나 type=; 숨긴 원본 표는 CSS 가 아니라 차트를 그린 뒤에 JS 가 숨긴다(JS 없는 자리·echarts 로드 실패·옛 리비전에서 숫자가 보이도록 — 2026-10-31 의 esm.sh 장애가 그 예); 원본 표는 InterpreterTable 의 public toHtmlString 에 지시문 줄을 바꿔 넘겨 받는다(renderTable 추출은 호출자가 하나뿐이라 따로 하지 않는다); echarts 는 WikiStatistics 가 이미 <script> 로 싣는 페이지에서 두 번 받지 않게 window.echarts 를 먼저 본다; Mermaid 의 지연 로더(AhaWiki.Mermaid.js)는 Chart 의 스크립트가 두 번째 사본이 되는 그 커밋에서 공용 스크립트(AhaWiki.LazyLibrary.js 같은 이름)로 뽑는다(단독 커밋으로는 하지 않는다 — 호출자가 하나다); 팔레트는 less.less 밖에서, 양 테마에서 확인한 뒤에. 하위 방향도 같이 묶인다 — table 낱말(원본 표를 보이기; js.js 의 스크롤 래퍼가 > 자식 선택자를 깨므로 래퍼 제외 목록에 넣는다), 열 고르기(#!var x/y 가 아니라 x=·y= 옵션으로, bar= 의 열 해석기를 public 으로 뽑아 같이 쓴다), 보이는 표의 필터·정렬 따라가기(처음 그릴 때 행 순서를 스냅샷해서 선 차트는 데이터 순서를 지키고, 이벤트는 triggerHandler 라 표 요소에 jQuery 로 직접 건다). 여러 계열의 선 차트가 필요한 페이지가 생기면.

3. See Also

3.2. Similar Pages

Similar pages by cosine similarity. Words after page name are term frequency.

  • 54.61% InterpreterTable table(22:32), bar(15:38), 같은(9:28), 숫자(7:23), 머리글(3:23), interpreter(9:15), tsv(2:20), 열을(5:14), 열은(1:17), all(2:14)
  • 34.14% Dev Editor table(22:19), js(8:32), edit(1:39), wiki(4:27), aha(3:25), interpreter(9:18), 같은(9:17), editor(4:18), bar(15:5), 것은(7:11)
  • 31.23% MacroSparkline table(22:8), sparkline(4:14), bar(15:1), interpreter(9:5), 같은(9:4), macro(3:9), 생기면(10:1), 숫자(7:3), 것은(7:1), 아니라(6:2)

3.3. Adjacent Pages

≤ 32
all
1.0x
1.0x
80
-120
ON
0/0
0/0
0.00
0
0 / 0
1.00x